Getting  Into  Production 


Chapter  10 


Google  App  Engine  Hosting 


• We  choose  App  Engine  as  a development  environment 
because  we  can  use  Google’s  infrastruture  for  hosting 

• Google  makes  the  rules  - and  we  learn  them 
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Resource 

Free  Default  Quota 

Billing  Enabled  Quota 

Daily 

Limit 

Maximum  Rate 

Daily 

Limit 

Maximum  Rate 

Requests 

1,300,000 

requests 

7,400 

requests/minute 

43,000,000 

requests 

30,000 

requests/minute 

Outgoing 

Bandwidth 

(billable. 

includes 

HTTPS) 

1 

gigabyte 

56 

megabytes/minute 

1 gigabyte 
free;  1,046 
gigabytes 
maximum 

740 

megabytes/minute 

Incoming 

Bandwidth 

(billable. 

includes 

HTTPS) 

1 

gigabyte 

56 

megabytes/minute 

1 gigabyte 
free;  1,046 
gigabytes 
maximum 

740 

megabytes/minute 

CPU  Time 
(billable! 

6.5  CPU- 
hours 

15CPU- 

minutes/minute 

6.5  CPU- 
hours  free; 
1,729 

CPU-hours 

maximum 

72CPU- 

minutes/minute 

Outarowina  the  maximums?  Reauest  an  increase. 

http://code.google.com/appengine/docs/quotas.html 


Resource 

Free  Default  Quota 

Billing  Enabled  Quota 

Daily  Limit 

Maximum  Rate 

Daily  Limit 

Maximum  Rate 

Mail  API 
Calls 

7,000  calls 

32  calls/minute 

1,700,000 

calls 

4,900  calls/minute 

Recipients 

Emailed 

(billable! 

2,000 

recipients 

8 recipients/minute 

2,000 

recipients 

free; 

7,400,000 

recipients 

maximum 

5,100 

recipients/minute 

Admins 

Emailed 

5,000  mails 

24  mails/minute 

3,000,000 

mails 

9,700  mails/minute 

Message 
Body  Data 
Sent 

60 

megabytes 

340 

kilobytes/minute 

29 

gigabytes 

84 

megabytes/minute 

Attachments 

Sent 

2,000 

attachments 

8 

attachments/minute 

2,900,000 

attachments 

8,100 

attachments/minute 

Attachment 
Data  Sent 

100 

megabytes 

560 

kilobytes/minute 

100 

gigabytes 

300 

megabytes/minute 

Outarowina  the  maximums?  Reauest  an  increase. 

http://code.google.com/appengine/docs/quotas.html 


Activating  Your  App  Engine 

• You  must  have  a Google  account  (i.e.  GMail) 

• Add  App  Engine  to  the  account 
• http://appengine.google.com 

• Will  require  a SMS-Capable  phone  and  number 


When  you  run  out... 


The  cost  for  computing  resources  is  as  follows: 


Resource 

Unit 

Unit  cost 

Outgoing  Bandwidth 

gigabytes 

$0.12 

Incoming  Bandwidth 

gigabytes 

$0.10 

CPU  Time 

CPU  hours 

$0.10 

Stored  Data 

gigabytes  per  month 

$0.15 

Recipients  Emailed 

recipients 

$0.0001 

http://code.google.com/appengine/docs/billing.html 


Making  a New  Application 


application:  ae- 1 2-ajax 
version:  I 
runtime:  python 
api_version:  I 

handlers: 

- url:  /static 
static  dir:  static 


Modify 

app.yaml 


- url:/_ah/admin.* 

script:  $PYTHON_LIB/google/appengine/ext/admin 
login:  admin 


- url:/* 
script:  index.py 


O O n 

Applications  Overview 

8 

w <&  + *’•>.  https://appengine.google.com/ 

C Q,-  url:  admin  Q 

Google  app  engine 

csev@umich.edu  | Mv  Account  | Help  | Sion  out 

My  Applications 

Application 

Title 

Current  Version 

ae-12-aiax 

AppEngineLeam  Ajax  Chat 

1 cS> 

ae-1 2-chat 

AE  Learn  Chat 

None  Deployed 

nb-codereview 

Personal  Code  Review 

1 [01 

C-eate  an  AddI  cat  on 


You  have  8 applications  remaining  Create  3H  Application 

© 2008  Gooola  l Terms  of  Application  Identifier: 

ae-12-ajax  .appspot.com  ( Check  Availability  ^ 

You  can  map  this  application  to  your  own  domain  later.  Learn  more 

Application  Title: 

AE  Learn  Chat 

Displayed  when  users  access  your  application. 

Authentication  Options  (Advanced):  Learn  more 

Google  App  Engine  provides  an  API  for  authenticating  your  users.  If  you  choose  not  to  use  this,  anyone  in  the  world  will  be  able  to 
access  your  application.  However,  if  you  choose  to  use  this,  youll  need  to  specify  now  who  can  sign  in  to  your  application: 

Open  to  all  Google  Accounts  users  (default) 

If  your  application  uses  authentication,  anyone  with  a valid  Google  Account  may  sign  in.  (This  includes  all  Gmail  Accounts,  but  does 
*not*  include  accounts  on  any  Google  Apps  domains.) 

Edit 


ooo 

CoogleAppEngineLauncher 

E3 

* • 

Run  Stop 

# ■ S £ 

Browse  Logs  SDK  Console  Edit 

© E3 

Deploy  Dashboard 

Sign  1 

in  to  GoogleAppEngine  with  your 

Google  Account 

Name 

Path 

Port 

• simplelti 

/Users/csev/dev/gapp/simplelti 

8082 

Email: 

csev@umich.edu 

• wiscrowd 

/Users/csev/dev/cloudcollab/tsugi/trunk 

8083 

Password: 

• ae-learn 

/Users/csev/dev/cloudcollab/appenginelearn 

8084 

^ Remember  password  in  keychain 

• ae-12-ajax  /Users/csev/Desktop/publish/book/appengine/svn/...  8085 


Log  Console  (ae-12-ajax) 


***  Running  appfg.py  with  the  following  flags: 

— no_cookies  --email=csev§umich.edu  — passin  update 
google_appengine/appcfg.py:41:  DeprecationWarning:  the  sha  module  is  deprecated;  use  the 
hashlib  module  instead 
os . path . join(DIR_PATH , ’lib',  ’antlr3'). 

Application:  ae-12-ajax;  version:  1. 

Server:  appengine.google.com. 

Scanning  files  on  local  disk. 

Initiating  update. 

Cloning  3 static  files. 

Cloning  12  application  files. 

Uploading  2 files  and  blobs. 

Uploaded  2 files  and  blobs 
Deploying  new  version. 

Checking  if  new  version  is  ready  to  serve. 

Will  check  again  in  1 seconds. 

Checking  if  new  version  is  ready  to  serve. 

Will  check  again  in  2 seconds. 

Checking  if  new  version  is  ready  to  serve. 

Will  check  again  in  4 seconds. 

Checking  if  new  version  is  ready  to  serve. 

Closing  update:  new  version  is  ready  to  start  serving. 


AppEngine 

| M | ► | | C ^ http://ae-12-ajax.appspot.com/chat  © - Or  Google 

App  Engine  Sites  Topics  Chat  Members  Logout (csevj 

AppEngine  Chat 

( Submit ) 

Yes  - it  is  actually  very  easy  to  use.  (noah)  Thu  01  Jan  2009 

Very  cool  - have  you  tested  the  new  version  feature  yet?  (csev)  Thu  01  Jan  2009 

We  are  up  and  running  on  appspot!  (noah)  Thu  01  Jan  2009 
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Development  Console 

Google  App  Engine 

ae-1 2-ajax  Development  Console 

Interactive  Console 

Datastore  Viewer 

Interactive  Console 

Memcache  Viewer 
Task  Queues 
XMPP 
Inbound  Mail 

from  google. appengine. ext  import  db 

# A Model  for  a User 
class  User (db. Model ) : 

account  - db . StringProperty ( ) 
password  - db. StringProperty! ) 
name  - db. StringProperty ( ) 

newuser  - User (name-"Chuck" , account»"csev" , 
password- " secret " ) ; 
newuser .put ( ) ; 

/, 

Run  Program 

Development  Console 


ae-12-ajax  Development  Console  - Datastore  Viewer 


* <5  + |0http: 

//ae-12-ajax. appspot. com/_ah/admin/datastore?kind=User  C (Q-  Google 

Google  App  Engine 

SDK  vUnknown 

ae-1 2-ajax  Development  Console 

Datastore  Viewer 

Interactive  Console 
Memcache  Viewer 

Datastore  Viewer 

Entity  Kind: 

Viewer  allows  you  to  run  GQL  queries  and  much  more! 

Results  1 - 1 of  1 

XMPP 
Inbound  Mail 

User  ( List  Entities 

Select  different  namesoace 

) ( Create  New  Entity  ) 

□ Key 

□ aophZSOx... 

ID  Key  Name  account  name 

93403  csev  Chuck 

password 

1 

©2009  Google 


Note  - You  must  enter  the  Entity  Kind  (there  is  no  drop-down) 


ooo 

Applications  Overview 

e 

◄ <&  + J&.  https://appengine.google.com/ 

C Qr  url:  admin  Q 

Google  app  engine 

csev@umich.edu  | Mv  Account  | Help  | Sion  out 

My  Applications 

Application 

Title 

Current  Version 

ae-12-aiax 

AppEngineLeam  Ajax  Chat 

It? 

ae-1 2-chat 

AELeam  Chat 

None  Deployed 

nb-codereview 

Personal  Code  Review 

1[? 

C-eate  an  Aool  cat  on 


Logs  - AppEngineLearn  Ajax  Chat 


+ | ■»>»http://appengine.google.com/logs?=&app_ld=ae-12-ajax&version_id=l. 3384485 1414860  <5  Q?  Coogle 


Google  app  engine 


csev@umich.edu  | Mv  Account  | Help  | Sion  out 
« Show  All  Applications 


Main 

Dashboard 
Quota  Details 

Filter  Logs  © 

Minimum  Severity:  |nfo^  @ Ogdons 

Tip:  Click  a log  line  to  show  or  hide  its  details.  SI  Expand  logs 

Loos 

1-20  Next  20  > 

Cron  Jobs 

(5  ■ 12-14  11:34AM  03.026  ’module1  object  has  no  attribute  ’GetQueues’  Traceback  (most  recent  call  last):  File  '/base/python 

Task  Queues 

ffl  B 12-14  11:32AM  23.317  ’module’  object  has  no  attribute  'GetQueues'  Traceback  (most  recent  call  last):  File  ‘/base/ python 

Datastore 

Si  B 12-14  11:31AM  46.695  'module'  object  has  no  attribute  'GetQueues'  Traceback  (most  recent  call  last):  File  ‘/base/python 

Indexes 

ffl  B 12-14  11:31AM  09.814  Creating  session  session-1753194277063394367 

Data  Viewer 

ffl  B 12-14  11:21AM  12.110  Checking  account=csev  pw=secret 

Statistics 

ffl  B 12-14  11:21AM  01.371  Adding  aecount=csev 

Administration 

© B 12-14  10:47AM  16.863  Creating  session  session-956044636692657434 

Application  Settinas 

© B 11-21  02:32PM  50.393  Invalidating  session  10814569095035721458  . 

Developers 

B 11-21  02:32PM  50.393  Creating  session  session-36364637789763545  N 0 

Versions 

ffl  B 11-21  01:14PM  55.526  Invalidating  session  988361652093113068  O 

Admin  Loos 

B 11-21  01:14PM  55.527  Creating  session  session-10814569095035721458 

Billing 

ffl  B 11-21  12:13PM  57.212  Checking  account=csev  pw=secret 

Billina  Settings 

ffl  B 11-21  12:12PM  43.354  Creating  session  session-988361652093113068 

Billing  History 

ffl  B 11-16  04:53PM  56.853  Creating  session  session-357312526805145544 

New  Version... 


• Make  changes  locally  - re-upload  to  replace  your  code  on 
the  server 

• You  can  have  multiple  versions  going  at  one  time  and 
control  which  is  active  by  changing  the  version  number  in 
the  app.yaml 


Developers  - AppEngineLearn  Ajax  Chat 

^ + *■. http://appengine. google. com/permissions?&app_id=ae-12-ajax&version_id=1.338448514148602;  <5  | Q?  Google 


Google  app  engine 


csev@umich.edu  | Mv  Account  | Help  | Sion  out 


a e- 12-ajax  ▼ 1 ▼ 


« Show  All  Applications 


Google  Account 

Status 

Remove  Access 

csev@umich.edu 

Active 

( Remove  ) 

noahbotimer@gmail.com 

Active 

(Remove) 

Cron  Jobs 
Task  Queues 


Invite  a Developer  to  Collaborate  on  this  Application: 

Enter  a complete  email  address 


Data  Viewer 
Statistics 

Administration 
Application  Settings 

Developers 


Collaborators 


application:  ae- 1 2-ajax 

version:  1 

Google  App  Engine 

runtime:  python 

ae-12-ajax  - 

13  _ 

api_version:  1 

Dashboard 
Quota  Details 

Logs 

handlers: 

Data  Viewer 

Want  to  host  your  application  on  another  domain?  Google  App  Engine  uses  Google  Adds  to  manage  domains.  Learn  more 

- url:  /static 

Developers 

static_dir:  static 

- url:  /admin/.* 

script:  $PYTHON_ 

_LIB/google/appengine/ext/admin 

login:  admin 

- url:/.* 

Normally  when  you  upload,  it  replaces 

script:  index.py 

the  copy  you  have  - unless  you  change 

the  version  - changing  the  version  is  rare. 

Google  Analytics 


Google  Analytics 

• Free  Google  service  to  track  usage  of  your  site 

• Steps: 

• Setup  Analytics 

• Add  Javascript  to  your  site 


Dashboard  - Coogle  Analytics 

+ Q https://www.google.com /analytics /reporting/?reset=l&id  = 12  73 12  83&pdr=2009 11 13 -2  009 12 13  C CV  analytics 


Google  Analytics 

E 


Jjl  Intelligence  95 
A Visitors 
“^Traffic  Sources 
0 Content 
p Goals 

0 Custom  Reporting 

My  Customlzations 

Q Custom  Reports 
® Advanced  Segments 


Help  Resources 

® About  this  Report 
® Conversion  University 
(?)  Common  Questions 


Export  ▼ ||  E3  Email 

Dashboard 


drchuck@gmall.com  | Settings  | My  Account  | Help  | Sign  Out 


Advanced  Segments:  | All  Visits  ▼ 

Nov  13,  2009 -Dec  13,  2009 


Graph  by:|g|B||=|| 


V 


A 571  Visits 
A-AavAtv*  748  Pageviews 
1.31  Pages/Visit 


83.01%  Bounce  Rate 
00:01 :04  Avg.  Time  on  S 
57.97%  % New  Visits 


attt  1 1 a i |TO 


Google  Analytics 

Don’t  have  a Google  account 
Sign  Up  Now. 


^Cy  analytics  O) 


©2009  Google  | Analytics  Home  | Terms  of  Service  | Privacy  Policy  | Contact  us  | Analytics  Blog  (in  English) 


% 


+ _)  https://www.google.eom/analytics/F 


Google  Analytics 


Analytics:  New  Account  Signup 

General  Information  > Contact  Information  > Accept  User  Agreement  > Add  Tracking 
Google  Analytics  reports.  If  youtiHke  to  track  more  than  one  website,  you  can  add  more  sites'once 


iking  Code  - Google  Analytics 


+JB https://wvw.google.com/analytics/provlslon/tracking7scld-12064502  C \ (Cfr  analytics 


Google  Analytics 


charles.severance@gmall.com  | Help  | Sign  Out 


©2009  Google  | Analytics  Home  | Terms  of  Service  | Privacy  Policy  | Contact  us  | Ana 


Analytics:  Tracking  Instructions 

General  Information  > Contactlnformatlon  > Accept  User  Agreement  > Add  Tracking 
Standard 


. How  do  I add  tracking  code  to  my 


entered  the  tracking  code 
correctly  on  my  pages? 

How  long  does  it  take  to  see 
report  data  after  adding  the 
tracking  oode? 


Dashboard  - Coogle  Analytics 


non 

•d  | ► <&  + 0 https://www.google.com /analytics /reporting/?reset=l&id  = 12  73 12  83&pdr=2009 11 13-2009 12 13 


C ] (O,-  analytics 


Google  Analytics 


drchuck@gmall.com  | Settings  | My  Account  | Help  | Sign  Out 


0 Custom  Reporting 


Help  Resources 

© About  this  Report 
© Conversion  University 
© Common  Questions 


Export  - E3  Email 

Advanced  Segments:  All  Visits  0 

Dashboard 

Nov  13,  2009 -Dec  13.  2009 

J a/1'  Visits 

Graph  by:  ^ |MI  1 1=1 1 

Nov  16  1 Nov  23 

Nov  30  1 Dec  7 

1 Site  Usage  1 

Ar'V^'V  571  Visits 

83.01%  Bounce  Rate 

A-A/hAv*  748  Pageviews 

00:01 :04  Avg.  Time  on  Site 

1.31  Pages/Visit 

57.97%  % New  Visits 

Map  Overlay 


* 


<div  id="bodycontent"> 

{%  block  bodycontent  %}  _base.htm 

Replace  this 
{%  endblock  %} 

</div> 

<script  type="text/javascript"> 

var  gaJsHost  = (("https:"  ==  document.location. protocol)  ? "https:// 
ssl." : "http://www."); 

document.write(unescape("%3Cscript  src='"  + gaJsHost  + "google- 
analytics.com/ga.js'  type='text/javascript,%3E%3C/script%3E")); 
</script> 

<script  type="text/javascript"> 
try  { 

var  pageTracker  = _gat._getTracker("UA-423997-9"); 
pageTrac  ke  r._t  rac  kPage  vi  e w () ; 

} catch(err)  {}</script> 

</html> 


Google  AdSense 

Work  for  Google!  Work  from  home! 


http://www.google.com/adsense/ 


AppEngineLearn 


◄ + ."http://www.appenginelearn.com/ 

1531  C Or  Google 

) 

AppEngineLearn 

EZ-Launch  Book  Author  Python  Add  Engine 

These  are  supporting  materials  for  the  O'Reilly  book  titled  Using  Google 
Add  Engine.  This  book  is  aimed  at  people  who  want  to  gain  skill  in  web 
programming  in  general  and  the  Google  App  Engine.  The  book  has  been 
used  to  support  many  beginning  courses  ranging  from  High  School  to 
College.  As  such  there  are  chapters  on  Python,  HTML,  CSS,  and  HTTP. 
More  advanced  programmers  will  likely  want  to  skip  over  the  first  few 
chapters. 

I see  Google  App  Engine  as  a way  for  virtually  everyone  to  have  their  own 
interactive  software-based  web  site  regardless  of  their  level  of 
programming  skills.  Increasingly,  web  programming  will  simply  need  to  be 
a competency  like  mathematics  and  this  book  is  dedicated  to  teaching 
everyone  about  Google  App  Engine. 


* You  can  download  the  Sample  Applications  from  the  book. 

> Installing  Python  and  Your  Programmer  Text  Editor 

» Installing  the  App  Engine  and  writing  your  first  Application, 
o Macintosh:  (Handout  Screencast  YouTube) 

o Windows  XP:  (Handout  Screencast.  and  YouTube) 

* You  may  want  to  also  download  the  Add  Engine  Helper  Scripts.  This 
is  a script  (one  for  Mac  and  one  for  Windows)  that  you  put  in  your 
apps  folder  to  launch  the  App  Engine.  These  scripts  simplify  setting 
the  paths,  etc.  There  is  a README.txt  file  in  the  ZIP  describing  how 
to  use  the  utilities. 

' The  Reguest  Dumper  Program  - dumps  out  the  HTTP  Request  Data 

(Handout.  Screencast.  YouTube). 

> A Basic  Web  Application  for  for  Google  App  Engine  (_ 

Screencast  YouTube). 


Internet  Marketing  Degree 

Learn  Search  Engine 

Optimization.  Get  Your  Marketing 

Degree  Online! 

www.FullSall.edu 

Python  Tutorials 

Exlusive  PDF  from  Mark 

Summerfield.  Free!  Enter  to  Win 

Python  Prizes. 

www.InformIT.oom 


Castrol  Anti-Sludge  Oil 
Superior  Protection  against 
Sludge  Build  Up.  Learn  about 
Castrol  GTX®. 

www.sludgeprotectlon.oom/Castrol 


* | ► | | <5  1 


Coogle  AdSense  - AdSense  for  Content 
is://www.google.com/adsense/adslot-add#section=l 


Google  AdSense 


<?  ] adsense  flj)t 

Last  login:  3 days  ago- Lpg_Out- Help  r 
Publisher  ID:  pub-0127400494105307 
( Search  AdSense  Help  ) 


Reports  My  Account 


Get  Ads  > AdSense  for  Content 


Resources 


» Ad  Filter  I Sjte  Authentication  | Ad  Review  Center  | Allowed  Sites 


AdSense  for  Content 

Choose  Ad  Type  > Choose  Ad  Format  and  Colors  > Choose  Ad  Channels  > Save  and  Get  Ad  Code 
Wizard  | Single  paoe 

You  can  customize  your  ads  to  fit  in  with  your  pages.  Use  the  options  below  to  specify  ad  size,  style,  and  more. 


Format 

Ad  units  come  in  a variety  of  sizes  - view  all  the  options  on  our 
Ad  Formats  page. 


300  x 250  Medium 


Colors 

Choose  from  one  of  our  pre-designed  color  palettes,  or  create 
your  own  palette.  Tips 

* Some  options  apply  to  text  ads  only. 

Sample 
Ad  Title 

Ad  text 
www.ad-url.com 

Ads  by  Google 


Palettes  ■ Pefault  Coogl*  P*1*"*  ’ 1 

Save  as  new  palette  | Edit  palettes 

Border  # [ffffff]  [^] 

Title  # | ooooff  I ^ 

Background  # ffffff  | 

Text  # oooooo 
URL  # oosooo;  ^ 


c 


Sign  Up  for  AdSense 


• Add  to  your  Google  Account 

• Will  need  identity  - will  call  you  on  the  phone 

• Once  you  make  revenue,  they  will  want  tax  information 


http://www.google.com/adsense/ 


index.htm 


{%  extends  "_base.htm"  %} 

{%  block  bodycontent  %} 

<div  style="float:right"> 

<script  type="text/javascript"> 
window.google_analytics_uacct  = "UA-423997-9"; 
</script> 

<script  type="text/javascript"><!— 
google_ad_client  = "pub-0127400494 1 05307"; 

/*  250x250  aelearn,  created  9/10/09  */ 
google_ad_slot  = "27045 1 0 1 99"; 
google_ad_width  = 250; 
google_ad_height  = 250; 

//--> 


-l>  .a 

AppEngir 


</script> 

<script  type="text/javascript" 

src="http://pagead2.googlesyndication.com/pagead/show_ads.js"> 

</script> 

</div> 

These  are  supporting  materials  for  the  O'Reilly  book  titled  ... 


pi 


Summary 


• Reasonable  hosting  is  free  for  up  to  10  applications  per 
Gmail  account  (and  cell  phone  number) 

• You  can  add  free  tracking  to  your  site  using  Google 
Analytics 

• You  can  make  money  with  Google  Ads  - probably  not  a 
good  idea  for  a portfolio  site  :) 


